gdk: Conflate GDK devices

Make GdkEvents hold a single GdkDevice. This device is closer to
the logical device conceptually, although it must be sufficient for
device checks (i.e. GdkInputSource), which makes it similar to the
physical devices.

Make the logical devices have a more accurate GdkInputSource where
needed, and conflate the event devices altogether.

gdk: Drop source_device argument from _gdk_display_device_grab_update()

It's just passed around and used nowhere.

gdk: Make events hold an axis array matching GdkAxisUse

Instead of doing device-specific translations of array positions,
use GdkAxisUse as an array index right away.

gdk: Make GdkDevice axis API internal

All outside interaction happens through gdk_event_get_axis(), no
device poking is necessary, nor axis to array index translations.

gdk: Remove gdk_device_get_axes()

Besides the implicit x/y assumptions, devices don't have axes. Those
are actually provided by the GdkDeviceTool driving the device, and
different tools may have different axes.

It does not make sense to offer this API that can change beneath
someone's feet, we now have gdk_device_tool_get_axes() which is static
to the tool.

inspector: Show tool axes, instead of device axes

We are moving away from the latter as they are inconsistent with
Wayland. Make the inspector introspect known tools and their info,
instead.

gdk: Add gdk_seat_get_tools() API call

There's GdkSeat::tool-added and ::tool-removed, but there's no
API to query the known tools. Add this call.

gdk: Add gdk_device_tool_get_axes()

Axes are actually a per-tool property, we just adapt devices to the
current tool.

docs: Correct migration note

A mentioned API call is now internal.

gdkdevice: Remove gdk_device_get_state()

This is not needed nor recommended anymore, all reasons to maybe
need this were all kept within gdk.

gtkwindow: Move away from gdk_device_get_state()

Use gdk_device_get_modifier_state() poking the keyboard and keymap,
instead of this function.

gtkpopover: Move away from gdk_device_get_state()

Use gdk_device_get_modifier_state() poking the keyboard and keymap,
instead of this function.

gdk: Drop GDK_SOURCE_CURSOR

Looking at the xf86-input-wacom driver code, this is not even a thing
anymore. Drop this device type, in modern days there's
GDK_DEVICE_TOOL_TYPE_MOUSE for this.

Merge branch 'wip/chergert/fix-macos-time-conversion' into 'master'

macos: support ARM/PowerPC time conversion for DisplayLink times

See merge request GNOME/gtk!2301

macos: support ARM/PowerPC time conversion for DisplayLink times

When converting DisplayLink frame presentation times, we need to take into
account the arch-specific types. This tracks changes in GNOME/GLib!1566 so
that precision is not lost.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2300

Update Ukrainian translation

gtk-demo: Simplify colors demo

Make best use of our new constructors.

NEWS: Tweak the wording

Merge branch 'a11y-docs' into 'master'

a11y: Document roles of widgets

See merge request GNOME/gtk!2299

docs: Flesh out the role table in the a11y intro

Add cross-references for all the widgets currently
implementing non-default roles.

a11y: Document roles of widgets

Add a section to the long description for each
widget that is using a non-default accessible role.

Update POTFILES.in and POTFILES.skip

Merge branch 'ebassi/a11y-fixes' into 'master'

Ebassi/a11y fixes

Closes #2955

See merge request GNOME/gtk!2298

a11y: Test unset relations

We use "NULL" in C to mean "undefined", when it comes to relations that
deal with references or reference lists.

a11y: Allow unsetting the relations using NULL

Accessible values storing references and reference lists can be unset by
using NULL to mean "undefined"; since we cannot return the NULL value,
we need to intercept it when collecting a value, and replace it with an
undefined GtkAccessibleValue, which is also the value used as the
default for GtkAccessibleRelation values that store a reference or a
reference list.

Fixes: #2955

docs: Document a11y attributes

NEWS: Updates

Merge branch 'ebassi/ci-dags' into 'master'

ci: Use DAG attributes

See merge request GNOME/gtk!2297

Merge branch 'ebassi/new-a11y' into 'master'

Accessibility rework

See merge request GNOME/gtk!2239

ci: Use DAG attributes

Some jobs can run out of order, as they are entirely self-contained. If
we use the newly added DAG attributes, we can speed up the CI pipeline.

a11y: Make GtkATContext.create() public

Implementations of the GtkAccessible interface should have a way to
instantiate the appropriate GtkATContext.

docs: Add missing GTK_ACCESSIBLE_VALUE_UNDEFINED

a11y: Add some more tests

Test that setting multiple states or properties
at the same time works as expected.

Add some more a11y tests

Add some tests that exercise the accessible machinery
without any connection to widgets.

a11y: Be a bit safer against crashes

We are collecting values from varargs and use them
as indices into static arrays. We should at least
do some bounds checking to prevent silly crashes.

docs: Expand GtkAccessible documentation

Add some hints and examples.

docs: Add documentation for accessible enumerations

This is largely taking text from the aria spec.

docs: Update GtkAccessibleRole docs

Sync up the docs with changed enum values, and document
all the roles that are used in GTK at the moment. All
others are left as "Unused".

docs: Fix up some issues in the a11y docs

Fix up syntax errors and links in the introductory
section about accessibility.

docs: Update a11y docs

Add some missing functions.

Merge branch 'drop-down-constructor' into 'master'

GtkDropDown api revisions

See merge request GNOME/gtk!2286

Merge branch 'list-constructors' into 'master'

List constructors

See merge request GNOME/gtk!2296

gridview: Revise constructors

Make both gtk_grid_view_new and gtk_grid_view_new_with_factory
take a model as first argument, and make all arguments
allow-none and transfer full.

Update all callers.

columnview: Revise the constructor

Make gtk_column_view_new take a model as first argument,
and make it allow-none and transfer full.

Update all callers.

listview: Revise constructors

Make both gtk_list_view_new and gtk_list_view_new_with_factory
take a model as first argument, and make all arguments
allow-none and transfer full.

Update all callers.

dropdown: Revise constructors

A dropdown without a model is useless, so accept a model
and expression in the constructor. Allow them to be NULL,
but consume them if given. This makes chained constructors
convenient without breaking language bindings.

Drop gtk_drop_down_set_from_strings() and instead add
gtk_drop_down_new_from_strings().

Update all users.

selectionfiltermodel: Make constructor allow-none

We don't pay attention to item-type anymore, so
drop the item-type property and the _for_item_type()
constructor, and allow passing NULL to the regular
constructor.

We don't make this constructor transfer-full, since
the selection filter model is not a wrapping model
like the others. It is more like fork than a wrap.

multiselection: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Also make the constructor return GtkMultiSelection *.

Update all callers.

singleselection: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

noselection: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

treelistmodel: Make constructor transfer full

Make gtk_tree_list_model_new() take the root model
as first argument, and make it transfer full, for
consistency with other wrapping list constructors.

Update all callers.

Still missing here: Make the model property writable,
and allow passing NULL in the constructor.

sortlistmodel: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

filterlistmodel: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

slicelistmodel: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

listlistmodel: Drop item_type

We are using G_TYPE_OBJECT throughout, so there
is no need for GtkListListModel to do anything else.

Update all callers.

maplistmodel: Make constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

flattenlistmodel: Make the constructor transfer full

This is for consistency with other wrapping list constructors.
We want them all to be transfer full, allow-none.

Update all callers.

ci: Re-enable the accessibility test suite

Now that we have something that is both reliable and local.

a11y: Add a simple test case for GtkButton's accessible state

a11y: Simplify the test API

We don't need as many functions to print out the property, relation, and
state of an accessible. Additionally, we should allow comparing the
accessible attributes with an expected value, and print out the real
accessible value if they do not match.

a11y: Allow setting the role post-construction

Some widgets have different roles after they are constructed, so we need
to allow changing the role defined by the class. We should still avoid
setting a role after the GtkATContext has been created.

a11y: Add API to retrieve accessible values

We are going to use this for implementing ATContext subclasses, but also
in the testing API.

a11y: Add more test API

a11y: Restart the accessibility test suite

Fix build with debugging notes disabled

a11y: Update GtkCheckButton

This is a bit unfortunate, since the aria modelling
doesn't quite agree with ours, so we have to listen
for the togglebutton property change, and we inherit
the pressed state from the togglebutton accessible.

a11y: Update GtkSpinButton

Set the appropriate accessible role, and update
the value properties.

a11y: Update GtkProgressBar

Update state and properties as appropriate.

testatcontext: Print role nicks

This makes for easier reading.

a11y: Update labelled-by when setting mnemonic labels

The ARIA labelled-by attribute behaves the same way as the mnemonic
labels in GTK.

a11y: Change the collection type for reflist attributes

a11y: Allow storing list of references in GtkAccessibleValue

It's one of the fundamental accessible value types in ARIA.

a11y: Change default accessible role

Only GtkWidget should use GTK_ACCESSIBLE_ROLE_WIDGET as its default
accessible role; the default for GtkAccessible and GtkATContext should
be GTK_ACCESSIBLE_ROLE_NONE, meaning "an element whose implicit native
role semantics will not be mapped to the accessibility API", according
to the WAI-ARIA specification.

inspector: Support the a11y debug flag

Add support for the GTK_DEBUG_A11Y debug flag in
the logs tab.

testatcontext: Use the new debug flag

Only dump a11y state if GTK_DEBUG=accessibility is set.

Add GTK_DEBUG=accessibility

Add a debug flag for accessibility-related debug spew.

a11y: Add testing API

We want to test the accessibility API, as well as the implementation
inside each widget. For that, we should expose an API that lets us
verify that a GtkAccessible has a given role, as well as a given
property.

The API follows the pattern of other GTest API:

 - a macro to assert that a condition is respected
 - a function that prints out the error message in case of failure

a11y: Implement role and state change in GtkSwitch

Set the "switch" role, and update the "checked" state when the :active
property is toggled.

a11y: Consolidate the attributes container

While we have split the various attributes for convenience, there's no
reason why we should have specialised data types for the attributes
container object.

a11y: Add relations API

Since we split relation attributes from the generic properties, we need
to add API for setting and retrieving their values.

a11y: Simplify GtkAccessibleValue

Reduce the amount of subclassing, by handling collection of fundamental
types directly from the generic code paths. We now handle boolean,
tristate, integer, number, string, and relation values in the generic
code path; if an attribute supports the "undefined" value, we return the
undefined value singleton.

a11y: Resync with the ARIA spec

Drop roles and properties that were deprecated in WAI-ARIA 1.1, and add
new roles and properties defined in WAI-ARIA 1.2 and later.

We also split the relationship properties into their own enumeration, so
we can keep the GtkAccessibleProperty type more compact.

Remove GTK_ACCESSIBLE_STATE_NONE

It's pointless, we can use an explicit value of `-1` everywhere.
Additionally, it complicates all code that uses the state enumeration as
an array index, since now we need to guard against a negative offset.

a11y: Add binding-friendly accessible property setter

Matching the one for the accessible state.

a11y: Collect reference value

Some properties that take a reference to an accessible haven't been
updated to collect the correct type.

a11y: Update the accessible label for GtkButton

a11y: Update GtkSeparator

Add an accessible role, and update the orientation state.

a11y: Set the role for GtkScale

a11y: Update the accessible state for GtkRange

a11y: Update the "pressed" state on toggle buttons

a11y: Add roles to various widgets

Add accessible properties to GtkAccessible

We propagate the accessible state and properties to each ATContext in
the same virtual function, since they are functionally similar.

Add GtkAccessiblePropertySet

Like GtkAccessibleStateSet, the PropertySet is a set for accessible
properties.

Plumb all the GtkAccessibleProperty values into GtkAccessibleValue

Similarly to how we deal with GtkAccessibleState.

Allow setting the accessible role at construction

Some widgets have different accessible roles depending on some
parameter, so we cannot set the role at class init time. For those
widgets, we add an "accessible-role" property to GtkAccessible, and we
allow setting it (only) at construction time.

Start documenting the Accessibility API

Add the introductory text from #2833, and the various types to the API
reference.

Update the accessible state on widget visibility changes

The GTK_ACCESSIBLE_STATE_HIDDEN has the opposite meaning of the
GtkWidget:visible property.

Have GtkWidget implement GtkAccessible

Each widget type has an accessible role associated to its class, as
roles cannot change during the life time of a widget instance.

Each widget is also responsible for creating an ATContext, to proxy
state changes to the underlying accessibility infrastructure.

Plug GtkATContext into GtkAccessible

An Accessible implementation must create an ATContext object. UI
elements are supposed to interact with the GtkAccessible API, but we
expose GtkATContext to allow patterns like delegation.